permalink: plugins/note-composer

Note composer

Note composer is a core plugin that lets you merge two notes or extract part of a note into a new note.

Merge notes

Merging notes adds a note to another and removes the first one. Note composer updates all links to reference the merged note.

When you select the note to merge into, you can choose between the following methods:

Enter: Adds the source note at the end to the destination note.
Shift+Enter: Adds the source note at the start of the destination note.
Ctrl+Enter (or Cmd+Enter on macOS): Creates a new note with the content of the source note.

To merge the active note with another note in your vault:

File explorer

In the File explorer, right-click the note you want to merge.
Click Merge entire file with....
Select the note you want to merge into.
Click Merge to confirm.

Command palette

Open the Command palette.
Select Note composer: Merge current file with another file....
Select the note you want to merge into.
Click Merge to confirm.

Tip

By default, Note composer asks you to confirm when merging notes. If you disable the confirmation, and you merge a note by mistake, you can still recover it with the File recovery plugin.

Extract note

When you select the note to extract the selection into, you can choose between the following methods:

Enter: Adds the selected text at the end to the destination note.
Shift+Enter: Adds the selected text at the start of the destination note.
Ctrl+Enter (or Cmd+Enter on macOS): Creates a new note with the selected text.

To extract text into a new note:

Editor

While in the Editing view, select the text you want to extract.
Right-click the selected text.
Click Extract current selection....
Select the note you want to extract into.

Command palette

While in the Editing view, select the text you want to extract.
Open the Command palette.
Select Note composer: Extract current selection....
Select the note you want to extract into.

Tip

By default, Note composer replaces the extracted text with a link to the destination note. Under settings, you can also change to instead embed the destination note, or to leave nothing behind.

Template file

By configuring a template, you can customize the content before you add it to the new note. To use a template, enter a Template file location in the plugin settings.

The template can contain the following variables:

Variable	Description
`{{content}}`	The content to merge, or the extracted text selection. If you don't include this variable, Note composer adds the content at the bottom of the template.
`{{fromTitle}}`	Name of the source note.
`{{newTitle}}`	Name of the destination note. For example, to add the file name as a heading at the top of the file.
`{{date:FORMAT}}`	Creation date of the new note. For example, `{{date:YYYY-MM-DD}}`.